<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
<html>
<head>
<meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
<title>AtkObject</title>
<meta name="generator" content="DocBook XSL Stylesheets V1.73.2">
<link rel="start" href="index.html" title="ATK - Accessibility Toolkit">
<link rel="up" href="atk.html" title="ATK Library">
<link rel="prev" href="AtkNoOpObjectFactory.html" title="AtkNoOpObjectFactory">
<link rel="next" href="AtkObjectFactory.html" title="AtkObjectFactory">
<meta name="generator" content="GTK-Doc V1.10 (XML mode)">
<link rel="stylesheet" href="style.css" type="text/css">
<link rel="chapter" href="atk.html" title="ATK Library">
<link rel="index" href="ix01.html" title="Index">
<link rel="index" href="ix02.html" title="Index of deprecated symbols">
<link rel="index" href="ix03.html" title="Index of new symbols in ATK 1.3">
<link rel="index" href="ix04.html" title="Index of new symbols in ATK 1.4">
<link rel="index" href="ix05.html" title="Index of new symbols in ATK 1.6">
<link rel="index" href="ix06.html" title="Index of new symbols in ATK 1.9">
<link rel="index" href="ix07.html" title="Index of new symbols in ATK 1.12">
</head>
<body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF">
<table class="navigation" id="top" width="100%" summary="Navigation header" cellpadding="2" cellspacing="2">
<tr valign="middle">
<td><a accesskey="p" href="AtkNoOpObjectFactory.html"><img src="left.png" width="24" height="24" border="0" alt="Prev"></a></td>
<td><a accesskey="u" href="atk.html"><img src="up.png" width="24" height="24" border="0" alt="Up"></a></td>
<td><a accesskey="h" href="index.html"><img src="home.png" width="24" height="24" border="0" alt="Home"></a></td>
<th width="100%" align="center">ATK - Accessibility Toolkit</th>
<td><a accesskey="n" href="AtkObjectFactory.html"><img src="right.png" width="24" height="24" border="0" alt="Next"></a></td>
</tr>
<tr><td colspan="5" class="shortcuts"><nobr><a href="#AtkObject.synopsis" class="shortcut">Top</a>
                   | 
                  <a href="#AtkObject.description" class="shortcut">Description</a>
                   | 
                  <a href="#AtkObject.object-hierarchy" class="shortcut">Object Hierarchy</a>
                   | 
                  <a href="#AtkObject.properties" class="shortcut">Properties</a>
                   | 
                  <a href="#AtkObject.signals" class="shortcut">Signals</a></nobr></td></tr>
</table>
<div class="refentry" lang="en">
<a name="AtkObject"></a><div class="titlepage"></div>
<div class="refnamediv"><table width="100%"><tr>
<td valign="top">
<h2><span class="refentrytitle"><a name="AtkObject.top_of_page"></a>AtkObject</span></h2>
<p>AtkObject — 
The base object class for the Accessibility Toolkit API.</p>
</td>
<td valign="top" align="right"></td>
</tr></table></div>
<div class="refsynopsisdiv">
<a name="AtkObject.synopsis"></a><h2>Synopsis</h2>
<pre class="synopsis">
                    <a class="link" href="AtkObject.html#AtkObject-struct" title="AtkObject">AtkObject</a>;
enum                <a class="link" href="AtkObject.html#AtkRole" title="enum AtkRole">AtkRole</a>;
<a class="link" href="AtkObject.html#AtkRole" title="enum AtkRole">AtkRole</a>             <a class="link" href="AtkObject.html#atk-role-register" title="atk_role_register ()">atk_role_register</a>                   (const <a
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gchar"
>gchar</a> *name);
enum                <a class="link" href="AtkObject.html#AtkLayer" title="enum AtkLayer">AtkLayer</a>;
                    <a class="link" href="AtkObject.html#AtkImplementor" title="AtkImplementor">AtkImplementor</a>;
                    <a class="link" href="AtkObject.html#AtkPropertyValues" title="AtkPropertyValues">AtkPropertyValues</a>;
<a
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gboolean"
>gboolean</a>            (<a class="link" href="AtkObject.html#AtkFunction" title="AtkFunction ()">*AtkFunction</a>)                      (<a
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gpointer"
>gpointer</a> data);
void                (<a class="link" href="AtkObject.html#AtkPropertyChangeHandler" title="AtkPropertyChangeHandler ()">*AtkPropertyChangeHandler</a>)         (<a class="link" href="AtkObject.html" title="AtkObject">AtkObject</a> *,
                                                         <a class="link" href="AtkObject.html#AtkPropertyValues" title="AtkPropertyValues">AtkPropertyValues</a> *);
<a class="link" href="AtkObject.html" title="AtkObject">AtkObject</a>*          <a class="link" href="AtkObject.html#atk-implementor-ref-accessible" title="atk_implementor_ref_accessible ()">atk_implementor_ref_accessible</a>      (<a class="link" href="AtkObject.html#AtkImplementor" title="AtkImplementor">AtkImplementor</a> *implementor);
const <a
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gchar"
>gchar</a>*        <a class="link" href="AtkObject.html#atk-object-get-name" title="atk_object_get_name ()">atk_object_get_name</a>                 (<a class="link" href="AtkObject.html" title="AtkObject">AtkObject</a> *accessible);
const <a
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gchar"
>gchar</a>*        <a class="link" href="AtkObject.html#atk-object-get-description" title="atk_object_get_description ()">atk_object_get_description</a>          (<a class="link" href="AtkObject.html" title="AtkObject">AtkObject</a> *accessible);
<a class="link" href="AtkObject.html" title="AtkObject">AtkObject</a>*          <a class="link" href="AtkObject.html#atk-object-get-parent" title="atk_object_get_parent ()">atk_object_get_parent</a>               (<a class="link" href="AtkObject.html" title="AtkObject">AtkObject</a> *accessible);
<a
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gint"
>gint</a>                <a class="link" href="AtkObject.html#atk-object-get-n-accessible-children" title="atk_object_get_n_accessible_children ()">atk_object_get_n_accessible_children</a>
                                                        (<a class="link" href="AtkObject.html" title="AtkObject">AtkObject</a> *accessible);
<a class="link" href="AtkObject.html" title="AtkObject">AtkObject</a>*          <a class="link" href="AtkObject.html#atk-object-ref-accessible-child" title="atk_object_ref_accessible_child ()">atk_object_ref_accessible_child</a>     (<a class="link" href="AtkObject.html" title="AtkObject">AtkObject</a> *accessible,
                                                         <a
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gint"
>gint</a> i);
<a class="link" href="AtkRelationSet.html" title="AtkRelationSet">AtkRelationSet</a>*     <a class="link" href="AtkObject.html#atk-object-ref-relation-set" title="atk_object_ref_relation_set ()">atk_object_ref_relation_set</a>         (<a class="link" href="AtkObject.html" title="AtkObject">AtkObject</a> *accessible);
<a class="link" href="AtkObject.html#AtkLayer" title="enum AtkLayer">AtkLayer</a>            <a class="link" href="AtkObject.html#atk-object-get-layer" title="atk_object_get_layer ()">atk_object_get_layer</a>                (<a class="link" href="AtkObject.html" title="AtkObject">AtkObject</a> *accessible);
<a
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gint"
>gint</a>                <a class="link" href="AtkObject.html#atk-object-get-mdi-zorder" title="atk_object_get_mdi_zorder ()">atk_object_get_mdi_zorder</a>           (<a class="link" href="AtkObject.html" title="AtkObject">AtkObject</a> *accessible);
<a class="link" href="AtkObject.html#AtkRole" title="enum AtkRole">AtkRole</a>             <a class="link" href="AtkObject.html#atk-object-get-role" title="atk_object_get_role ()">atk_object_get_role</a>                 (<a class="link" href="AtkObject.html" title="AtkObject">AtkObject</a> *accessible);
AtkStateSet*        <a class="link" href="AtkObject.html#atk-object-ref-state-set" title="atk_object_ref_state_set ()">atk_object_ref_state_set</a>            (<a class="link" href="AtkObject.html" title="AtkObject">AtkObject</a> *accessible);
<a
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gint"
>gint</a>                <a class="link" href="AtkObject.html#atk-object-get-index-in-parent" title="atk_object_get_index_in_parent ()">atk_object_get_index_in_parent</a>      (<a class="link" href="AtkObject.html" title="AtkObject">AtkObject</a> *accessible);
void                <a class="link" href="AtkObject.html#atk-object-set-name" title="atk_object_set_name ()">atk_object_set_name</a>                 (<a class="link" href="AtkObject.html" title="AtkObject">AtkObject</a> *accessible,
                                                         const <a
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gchar"
>gchar</a> *name);
void                <a class="link" href="AtkObject.html#atk-object-set-description" title="atk_object_set_description ()">atk_object_set_description</a>          (<a class="link" href="AtkObject.html" title="AtkObject">AtkObject</a> *accessible,
                                                         const <a
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gchar"
>gchar</a> *description);
void                <a class="link" href="AtkObject.html#atk-object-set-parent" title="atk_object_set_parent ()">atk_object_set_parent</a>               (<a class="link" href="AtkObject.html" title="AtkObject">AtkObject</a> *accessible,
                                                         <a class="link" href="AtkObject.html" title="AtkObject">AtkObject</a> *parent);
void                <a class="link" href="AtkObject.html#atk-object-set-role" title="atk_object_set_role ()">atk_object_set_role</a>                 (<a class="link" href="AtkObject.html" title="AtkObject">AtkObject</a> *accessible,
                                                         <a class="link" href="AtkObject.html#AtkRole" title="enum AtkRole">AtkRole</a> role);
<a
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#guint"
>guint</a>               <a class="link" href="AtkObject.html#atk-object-connect-property-change-handler" title="atk_object_connect_property_change_handler ()">atk_object_connect_property_change_handler</a>
                                                        (<a class="link" href="AtkObject.html" title="AtkObject">AtkObject</a> *accessible,
                                                         <a class="link" href="AtkObject.html#AtkPropertyChangeHandler" title="AtkPropertyChangeHandler ()">AtkPropertyChangeHandler</a> *handler);
void                <a class="link" href="AtkObject.html#atk-object-remove-property-change-handler" title="atk_object_remove_property_change_handler ()">atk_object_remove_property_change_handler</a>
                                                        (<a class="link" href="AtkObject.html" title="AtkObject">AtkObject</a> *accessible,
                                                         <a
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#guint"
>guint</a> handler_id);
void                <a class="link" href="AtkObject.html#atk-object-notify-state-change" title="atk_object_notify_state_change ()">atk_object_notify_state_change</a>      (<a class="link" href="AtkObject.html" title="AtkObject">AtkObject</a> *accessible,
                                                         <a class="link" href="atk-AtkState.html#AtkState" title="AtkState">AtkState</a> state,
                                                         <a
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gboolean"
>gboolean</a> value);
void                <a class="link" href="AtkObject.html#atk-object-initialize" title="atk_object_initialize ()">atk_object_initialize</a>               (<a class="link" href="AtkObject.html" title="AtkObject">AtkObject</a> *accessible,
                                                         <a
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gpointer"
>gpointer</a> data);
<a
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gboolean"
>gboolean</a>            <a class="link" href="AtkObject.html#atk-object-add-relationship" title="atk_object_add_relationship ()">atk_object_add_relationship</a>         (<a class="link" href="AtkObject.html" title="AtkObject">AtkObject</a> *object,
                                                         <a class="link" href="AtkRelation.html#AtkRelationType" title="enum AtkRelationType">AtkRelationType</a> relationship,
                                                         <a class="link" href="AtkObject.html" title="AtkObject">AtkObject</a> *target);
<a
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gboolean"
>gboolean</a>            <a class="link" href="AtkObject.html#atk-object-remove-relationship" title="atk_object_remove_relationship ()">atk_object_remove_relationship</a>      (<a class="link" href="AtkObject.html" title="AtkObject">AtkObject</a> *object,
                                                         <a class="link" href="AtkRelation.html#AtkRelationType" title="enum AtkRelationType">AtkRelationType</a> relationship,
                                                         <a class="link" href="AtkObject.html" title="AtkObject">AtkObject</a> *target);
<a class="link" href="AtkText.html#AtkAttributeSet" title="AtkAttributeSet">AtkAttributeSet</a>*    <a class="link" href="AtkObject.html#atk-object-get-attributes" title="atk_object_get_attributes ()">atk_object_get_attributes</a>           (<a class="link" href="AtkObject.html" title="AtkObject">AtkObject</a> *accessible);
const <a
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gchar"
>gchar</a>*        <a class="link" href="AtkObject.html#atk-role-get-name" title="atk_role_get_name ()">atk_role_get_name</a>                   (<a class="link" href="AtkObject.html#AtkRole" title="enum AtkRole">AtkRole</a> role);
const <a
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gchar"
>gchar</a>*        <a class="link" href="AtkObject.html#atk-role-get-localized-name" title="atk_role_get_localized_name ()">atk_role_get_localized_name</a>         (<a class="link" href="AtkObject.html#AtkRole" title="enum AtkRole">AtkRole</a> role);
<a class="link" href="AtkObject.html#AtkRole" title="enum AtkRole">AtkRole</a>             <a class="link" href="AtkObject.html#atk-role-for-name" title="atk_role_for_name ()">atk_role_for_name</a>                   (const <a
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gchar"
>gchar</a> *name);
</pre>
</div>
<div class="refsect1" lang="en">
<a name="AtkObject.object-hierarchy"></a><h2>Object Hierarchy</h2>
<pre class="synopsis">
  <a
href="/usr/share/gtk-doc/html/gobject/gobject-The-Base-Object-Type.html#GObject"
>GObject</a>
   +----AtkObject
         +----<a class="link" href="AtkGObjectAccessible.html" title="AtkGObjectAccessible">AtkGObjectAccessible</a>
         +----<a class="link" href="AtkNoOpObject.html" title="AtkNoOpObject">AtkNoOpObject</a>
</pre>
</div>
<div class="refsect1" lang="en">
<a name="AtkObject.properties"></a><h2>Properties</h2>
<pre class="synopsis">
  "<a class="link" href="AtkObject.html#AtkObject--accessible-component-layer" title='The "accessible-component-layer" property'>accessible-component-layer</a>" <a
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gint"
>gint</a>                  : Read
  "<a class="link" href="AtkObject.html#AtkObject--accessible-component-mdi-zorder" title='The "accessible-component-mdi-zorder" property'>accessible-component-mdi-zorder</a>" <a
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gint"
>gint</a>                  : Read
  "<a class="link" href="AtkObject.html#AtkObject--accessible-description" title='The "accessible-description" property'>accessible-description</a>"   <a
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gchar"
>gchar</a>*                : Read / Write
  "<a class="link" href="AtkObject.html#AtkObject--accessible-hypertext-nlinks" title='The "accessible-hypertext-nlinks" property'>accessible-hypertext-nlinks</a>" <a
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gint"
>gint</a>                  : Read
  "<a class="link" href="AtkObject.html#AtkObject--accessible-name" title='The "accessible-name" property'>accessible-name</a>"          <a
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gchar"
>gchar</a>*                : Read / Write
  "<a class="link" href="AtkObject.html#AtkObject--accessible-parent" title='The "accessible-parent" property'>accessible-parent</a>"        <a class="link" href="AtkObject.html" title="AtkObject">AtkObject</a>*            : Read / Write
  "<a class="link" href="AtkObject.html#AtkObject--accessible-role" title='The "accessible-role" property'>accessible-role</a>"          <a
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gint"
>gint</a>                  : Read / Write
  "<a class="link" href="AtkObject.html#AtkObject--accessible-table-caption" title='The "accessible-table-caption" property'>accessible-table-caption</a>" <a
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gchar"
>gchar</a>*                : Read / Write
  "<a class="link" href="AtkObject.html#AtkObject--accessible-table-caption-object" title='The "accessible-table-caption-object" property'>accessible-table-caption-object</a>" <a class="link" href="AtkObject.html" title="AtkObject">AtkObject</a>*            : Read / Write
  "<a class="link" href="AtkObject.html#AtkObject--accessible-table-column-description" title='The "accessible-table-column-description" property'>accessible-table-column-description</a>" <a
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gchar"
>gchar</a>*                : Read / Write
  "<a class="link" href="AtkObject.html#AtkObject--accessible-table-column-header" title='The "accessible-table-column-header" property'>accessible-table-column-header</a>" <a class="link" href="AtkObject.html" title="AtkObject">AtkObject</a>*            : Read / Write
  "<a class="link" href="AtkObject.html#AtkObject--accessible-table-row-description" title='The "accessible-table-row-description" property'>accessible-table-row-description</a>" <a
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gchar"
>gchar</a>*                : Read / Write
  "<a class="link" href="AtkObject.html#AtkObject--accessible-table-row-header" title='The "accessible-table-row-header" property'>accessible-table-row-header</a>" <a class="link" href="AtkObject.html" title="AtkObject">AtkObject</a>*            : Read / Write
  "<a class="link" href="AtkObject.html#AtkObject--accessible-table-summary" title='The "accessible-table-summary" property'>accessible-table-summary</a>" <a class="link" href="AtkObject.html" title="AtkObject">AtkObject</a>*            : Read / Write
  "<a class="link" href="AtkObject.html#AtkObject--accessible-value" title='The "accessible-value" property'>accessible-value</a>"         <a
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gdouble"
>gdouble</a>               : Read / Write
</pre>
</div>
<div class="refsect1" lang="en">
<a name="AtkObject.signals"></a><h2>Signals</h2>
<pre class="synopsis">
  "<a class="link" href="AtkObject.html#AtkObject-active-descendant-changed" title='The "active-descendant-changed" signal'>active-descendant-changed</a>"                      : Run Last / Has Details
  "<a class="link" href="AtkObject.html#AtkObject-children-changed" title='The "children-changed" signal'>children-changed</a>"                               : Run Last / Has Details
  "<a class="link" href="AtkObject.html#AtkObject-focus-event" title='The "focus-event" signal'>focus-event</a>"                                    : Run Last
  "<a class="link" href="AtkObject.html#AtkObject-property-change" title='The "property-change" signal'>property-change</a>"                                : Run Last / Has Details
  "<a class="link" href="AtkObject.html#AtkObject-state-change" title='The "state-change" signal'>state-change</a>"                                   : Run Last / Has Details
  "<a class="link" href="AtkObject.html#AtkObject-visible-data-changed" title='The "visible-data-changed" signal'>visible-data-changed</a>"                           : Run Last
</pre>
</div>
<div class="refsect1" lang="en">
<a name="AtkObject.description"></a><h2>Description</h2>
<p>
This class is the primary class for accessibility support via
the Accessibility ToolKit (ATK).  Objects which are instances
of <a class="link" href="AtkObject.html" title="AtkObject"><span class="type">AtkObject</span></a> (or instances of AtkObject-derived types) are
queried for properties which relate basic (and generic) properties of a
UI component such as name and description.  Instances of <a class="link" href="AtkObject.html" title="AtkObject"><span class="type">AtkObject</span></a>
may also be queried as to whether they implement other ATK interfaces
(e.g. <a class="link" href="AtkAction.html" title="AtkAction"><span class="type">AtkAction</span></a>, <a class="link" href="AtkComponent.html" title="AtkComponent"><span class="type">AtkComponent</span></a>, etc.), as appropriate to the role
which a given UI component plays in a user interface.
</p>
<p>All UI components in an application which provide useful
information or services to the user must provide corresponding
<a class="link" href="AtkObject.html" title="AtkObject"><span class="type">AtkObject</span></a> instances on request (in GTK+, for instance, usually
on a call to #<a
href="/usr/share/gtk-doc/html/gtk/GtkWidget.html#gtk-widget-get-accessible"
><code class="function">gtk_widget_get_accessible()</code></a>), either via ATK support
built into the toolkit for the widget class or ancestor class, or in
the case of custom widgets, if the inherited <a class="link" href="AtkObject.html" title="AtkObject"><span class="type">AtkObject</span></a> implementation
is insufficient, via instances of a new <a class="link" href="AtkObject.html" title="AtkObject"><span class="type">AtkObject</span></a> subclass. 
</p>
</div>
<div class="refsect1" lang="en">
<a name="AtkObject.details"></a><h2>Details</h2>
<div class="refsect2" lang="en">
<a name="AtkObject-struct"></a><h3>AtkObject</h3>
<pre class="programlisting">typedef struct _AtkObject AtkObject;</pre>
<p>
The AtkObject structure should not be accessed directly.

</p>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="AtkRole"></a><h3>enum AtkRole</h3>
<pre class="programlisting">typedef enum
{
  ATK_ROLE_INVALID = 0, 
  ATK_ROLE_ACCEL_LABEL,
  ATK_ROLE_ALERT,
  ATK_ROLE_ANIMATION,
  ATK_ROLE_ARROW,
  ATK_ROLE_CALENDAR,
  ATK_ROLE_CANVAS,
  ATK_ROLE_CHECK_BOX,
  ATK_ROLE_CHECK_MENU_ITEM,
  ATK_ROLE_COLOR_CHOOSER,
  ATK_ROLE_COLUMN_HEADER,
  ATK_ROLE_COMBO_BOX,
  ATK_ROLE_DATE_EDITOR,
  ATK_ROLE_DESKTOP_ICON,
  ATK_ROLE_DESKTOP_FRAME,
  ATK_ROLE_DIAL,
  ATK_ROLE_DIALOG,
  ATK_ROLE_DIRECTORY_PANE,
  ATK_ROLE_DRAWING_AREA,
  ATK_ROLE_FILE_CHOOSER,
  ATK_ROLE_FILLER,
  ATK_ROLE_FONT_CHOOSER,
  ATK_ROLE_FRAME,
  ATK_ROLE_GLASS_PANE,
  ATK_ROLE_HTML_CONTAINER,
  ATK_ROLE_ICON,
  ATK_ROLE_IMAGE,
  ATK_ROLE_INTERNAL_FRAME,
  ATK_ROLE_LABEL,
  ATK_ROLE_LAYERED_PANE,
  ATK_ROLE_LIST,
  ATK_ROLE_LIST_ITEM,
  ATK_ROLE_MENU,
  ATK_ROLE_MENU_BAR,
  ATK_ROLE_MENU_ITEM,
  ATK_ROLE_OPTION_PANE,
  ATK_ROLE_PAGE_TAB,
  ATK_ROLE_PAGE_TAB_LIST,
  ATK_ROLE_PANEL,
  ATK_ROLE_PASSWORD_TEXT,
  ATK_ROLE_POPUP_MENU,
  ATK_ROLE_PROGRESS_BAR,
  ATK_ROLE_PUSH_BUTTON,
  ATK_ROLE_RADIO_BUTTON,
  ATK_ROLE_RADIO_MENU_ITEM,
  ATK_ROLE_ROOT_PANE,
  ATK_ROLE_ROW_HEADER,
  ATK_ROLE_SCROLL_BAR,
  ATK_ROLE_SCROLL_PANE,
  ATK_ROLE_SEPARATOR,
  ATK_ROLE_SLIDER,
  ATK_ROLE_SPLIT_PANE,
  ATK_ROLE_SPIN_BUTTON,
  ATK_ROLE_STATUSBAR,
  ATK_ROLE_TABLE,
  ATK_ROLE_TABLE_CELL,
  ATK_ROLE_TABLE_COLUMN_HEADER,
  ATK_ROLE_TABLE_ROW_HEADER,
  ATK_ROLE_TEAR_OFF_MENU_ITEM,
  ATK_ROLE_TERMINAL,
  ATK_ROLE_TEXT,
  ATK_ROLE_TOGGLE_BUTTON,
  ATK_ROLE_TOOL_BAR,
  ATK_ROLE_TOOL_TIP,
  ATK_ROLE_TREE,
  ATK_ROLE_TREE_TABLE,
  ATK_ROLE_UNKNOWN,
  ATK_ROLE_VIEWPORT,
  ATK_ROLE_WINDOW,
  ATK_ROLE_HEADER,
  ATK_ROLE_FOOTER,
  ATK_ROLE_PARAGRAPH,
  ATK_ROLE_RULER,
  ATK_ROLE_APPLICATION,
  ATK_ROLE_AUTOCOMPLETE,
  ATK_ROLE_EDITBAR,
  ATK_ROLE_EMBEDDED,
  ATK_ROLE_ENTRY,
  ATK_ROLE_CHART,
  ATK_ROLE_CAPTION,
  ATK_ROLE_DOCUMENT_FRAME,
  ATK_ROLE_HEADING,
  ATK_ROLE_PAGE,
  ATK_ROLE_SECTION,
  ATK_ROLE_REDUNDANT_OBJECT,
  ATK_ROLE_FORM,
  ATK_ROLE_LINK,
  ATK_ROLE_INPUT_METHOD_WINDOW,
  ATK_ROLE_LAST_DEFINED
} AtkRole;
</pre>
<p>
Describes the role of an object
</p>
<p>
These are the built-in enumerated roles that UI components can have in
ATK.  Other roles may be added at runtime, so an AtkRole &gt;=
ATK_ROLE_LAST_DEFINED is not necessarily an error.</p>
<p>
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td><p><a name="ATK-ROLE-INVALID:CAPS"></a><span class="term"><code class="literal">ATK_ROLE_INVALID</code></span></p></td>
<td> Invalid role
</td>
</tr>
<tr>
<td><p><a name="ATK-ROLE-ACCEL-LABEL:CAPS"></a><span class="term"><code class="literal">ATK_ROLE_ACCEL_LABEL</code></span></p></td>
<td> A label which represents an accelerator
</td>
</tr>
<tr>
<td><p><a name="ATK-ROLE-ALERT:CAPS"></a><span class="term"><code class="literal">ATK_ROLE_ALERT</code></span></p></td>
<td> An object which is an alert to the user. Assistive Technologies typically respond to ATK_ROLE_ALERT by reading the entire onscreen contents of containers advertising this role.  Should be used for warning dialogs, etc.
</td>
</tr>
<tr>
<td><p><a name="ATK-ROLE-ANIMATION:CAPS"></a><span class="term"><code class="literal">ATK_ROLE_ANIMATION</code></span></p></td>
<td> An object which is an animated image
</td>
</tr>
<tr>
<td><p><a name="ATK-ROLE-ARROW:CAPS"></a><span class="term"><code class="literal">ATK_ROLE_ARROW</code></span></p></td>
<td> An arrow in one of the four cardinal directions
</td>
</tr>
<tr>
<td><p><a name="ATK-ROLE-CALENDAR:CAPS"></a><span class="term"><code class="literal">ATK_ROLE_CALENDAR</code></span></p></td>
<td>  An object that displays a calendar and allows the user to select a date
</td>
</tr>
<tr>
<td><p><a name="ATK-ROLE-CANVAS:CAPS"></a><span class="term"><code class="literal">ATK_ROLE_CANVAS</code></span></p></td>
<td> An object that can be drawn into and is used to trap events
</td>
</tr>
<tr>
<td><p><a name="ATK-ROLE-CHECK-BOX:CAPS"></a><span class="term"><code class="literal">ATK_ROLE_CHECK_BOX</code></span></p></td>
<td> A choice that can be checked or unchecked and provides a separate indicator for the current state
</td>
</tr>
<tr>
<td><p><a name="ATK-ROLE-CHECK-MENU-ITEM:CAPS"></a><span class="term"><code class="literal">ATK_ROLE_CHECK_MENU_ITEM</code></span></p></td>
<td> A menu item with a check box
</td>
</tr>
<tr>
<td><p><a name="ATK-ROLE-COLOR-CHOOSER:CAPS"></a><span class="term"><code class="literal">ATK_ROLE_COLOR_CHOOSER</code></span></p></td>
<td> A specialized dialog that lets the user choose a color
</td>
</tr>
<tr>
<td><p><a name="ATK-ROLE-COLUMN-HEADER:CAPS"></a><span class="term"><code class="literal">ATK_ROLE_COLUMN_HEADER</code></span></p></td>
<td> The header for a column of data
</td>
</tr>
<tr>
<td><p><a name="ATK-ROLE-COMBO-BOX:CAPS"></a><span class="term"><code class="literal">ATK_ROLE_COMBO_BOX</code></span></p></td>
<td> A list of choices the user can select from
</td>
</tr>
<tr>
<td><p><a name="ATK-ROLE-DATE-EDITOR:CAPS"></a><span class="term"><code class="literal">ATK_ROLE_DATE_EDITOR</code></span></p></td>
<td> An object whose purpose is to allow a user to edit a date
</td>
</tr>
<tr>
<td><p><a name="ATK-ROLE-DESKTOP-ICON:CAPS"></a><span class="term"><code class="literal">ATK_ROLE_DESKTOP_ICON</code></span></p></td>
<td> An inconifed internal frame within a DESKTOP_PANE
</td>
</tr>
<tr>
<td><p><a name="ATK-ROLE-DESKTOP-FRAME:CAPS"></a><span class="term"><code class="literal">ATK_ROLE_DESKTOP_FRAME</code></span></p></td>
<td> A pane that supports internal frames and iconified versions of those internal frames
</td>
</tr>
<tr>
<td><p><a name="ATK-ROLE-DIAL:CAPS"></a><span class="term"><code class="literal">ATK_ROLE_DIAL</code></span></p></td>
<td> An object whose purpose is to allow a user to set a value
</td>
</tr>
<tr>
<td><p><a name="ATK-ROLE-DIALOG:CAPS"></a><span class="term"><code class="literal">ATK_ROLE_DIALOG</code></span></p></td>
<td> A top level window with title bar and a border
</td>
</tr>
<tr>
<td><p><a name="ATK-ROLE-DIRECTORY-PANE:CAPS"></a><span class="term"><code class="literal">ATK_ROLE_DIRECTORY_PANE</code></span></p></td>
<td> A pane that allows the user to navigate through and select the contents of a directory
</td>
</tr>
<tr>
<td><p><a name="ATK-ROLE-DRAWING-AREA:CAPS"></a><span class="term"><code class="literal">ATK_ROLE_DRAWING_AREA</code></span></p></td>
<td> An object used for drawing custom user interface elements
</td>
</tr>
<tr>
<td><p><a name="ATK-ROLE-FILE-CHOOSER:CAPS"></a><span class="term"><code class="literal">ATK_ROLE_FILE_CHOOSER</code></span></p></td>
<td> A specialized dialog that lets the user choose a file
</td>
</tr>
<tr>
<td><p><a name="ATK-ROLE-FILLER:CAPS"></a><span class="term"><code class="literal">ATK_ROLE_FILLER</code></span></p></td>
<td> A object that fills up space in a user interface
</td>
</tr>
<tr>
<td><p><a name="ATK-ROLE-FONT-CHOOSER:CAPS"></a><span class="term"><code class="literal">ATK_ROLE_FONT_CHOOSER</code></span></p></td>
<td> A specialized dialog that lets the user choose a font
</td>
</tr>
<tr>
<td><p><a name="ATK-ROLE-FRAME:CAPS"></a><span class="term"><code class="literal">ATK_ROLE_FRAME</code></span></p></td>
<td> A top level window with a title bar, border, menubar, etc.
</td>
</tr>
<tr>
<td><p><a name="ATK-ROLE-GLASS-PANE:CAPS"></a><span class="term"><code class="literal">ATK_ROLE_GLASS_PANE</code></span></p></td>
<td> A pane that is guaranteed to be painted on top of all panes beneath it
</td>
</tr>
<tr>
<td><p><a name="ATK-ROLE-HTML-CONTAINER:CAPS"></a><span class="term"><code class="literal">ATK_ROLE_HTML_CONTAINER</code></span></p></td>
<td> A document container for HTML, whose children represent the document content
</td>
</tr>
<tr>
<td><p><a name="ATK-ROLE-ICON:CAPS"></a><span class="term"><code class="literal">ATK_ROLE_ICON</code></span></p></td>
<td> A small fixed size picture, typically used to decorate components
</td>
</tr>
<tr>
<td><p><a name="ATK-ROLE-IMAGE:CAPS"></a><span class="term"><code class="literal">ATK_ROLE_IMAGE</code></span></p></td>
<td> An object whose primary purpose is to display an image
</td>
</tr>
<tr>
<td><p><a name="ATK-ROLE-INTERNAL-FRAME:CAPS"></a><span class="term"><code class="literal">ATK_ROLE_INTERNAL_FRAME</code></span></p></td>
<td> A frame-like object that is clipped by a desktop pane
</td>
</tr>
<tr>
<td><p><a name="ATK-ROLE-LABEL:CAPS"></a><span class="term"><code class="literal">ATK_ROLE_LABEL</code></span></p></td>
<td> An object used to present an icon or short string in an interface
</td>
</tr>
<tr>
<td><p><a name="ATK-ROLE-LAYERED-PANE:CAPS"></a><span class="term"><code class="literal">ATK_ROLE_LAYERED_PANE</code></span></p></td>
<td> A specialized pane that allows its children to be drawn in layers, providing a form of stacking order
</td>
</tr>
<tr>
<td><p><a name="ATK-ROLE-LIST:CAPS"></a><span class="term"><code class="literal">ATK_ROLE_LIST</code></span></p></td>
<td> An object that presents a list of objects to the user and allows the user to select one or more of them 
</td>
</tr>
<tr>
<td><p><a name="ATK-ROLE-LIST-ITEM:CAPS"></a><span class="term"><code class="literal">ATK_ROLE_LIST_ITEM</code></span></p></td>
<td> An object that represents an element of a list 
</td>
</tr>
<tr>
<td><p><a name="ATK-ROLE-MENU:CAPS"></a><span class="term"><code class="literal">ATK_ROLE_MENU</code></span></p></td>
<td> An object usually found inside a menu bar that contains a list of actions the user can choose from
</td>
</tr>
<tr>
<td><p><a name="ATK-ROLE-MENU-BAR:CAPS"></a><span class="term"><code class="literal">ATK_ROLE_MENU_BAR</code></span></p></td>
<td> An object usually drawn at the top of the primary dialog box of an application that contains a list of menus the user can choose from 
</td>
</tr>
<tr>
<td><p><a name="ATK-ROLE-MENU-ITEM:CAPS"></a><span class="term"><code class="literal">ATK_ROLE_MENU_ITEM</code></span></p></td>
<td> An object usually contained in a menu that presents an action the user can choose
</td>
</tr>
<tr>
<td><p><a name="ATK-ROLE-OPTION-PANE:CAPS"></a><span class="term"><code class="literal">ATK_ROLE_OPTION_PANE</code></span></p></td>
<td> A specialized pane whose primary use is inside a DIALOG
</td>
</tr>
<tr>
<td><p><a name="ATK-ROLE-PAGE-TAB:CAPS"></a><span class="term"><code class="literal">ATK_ROLE_PAGE_TAB</code></span></p></td>
<td> An object that is a child of a page tab list
</td>
</tr>
<tr>
<td><p><a name="ATK-ROLE-PAGE-TAB-LIST:CAPS"></a><span class="term"><code class="literal">ATK_ROLE_PAGE_TAB_LIST</code></span></p></td>
<td> An object that presents a series of panels (or page tabs), one at a time, through some mechanism provided by the object 
</td>
</tr>
<tr>
<td><p><a name="ATK-ROLE-PANEL:CAPS"></a><span class="term"><code class="literal">ATK_ROLE_PANEL</code></span></p></td>
<td> A generic container that is often used to group objects
</td>
</tr>
<tr>
<td><p><a name="ATK-ROLE-PASSWORD-TEXT:CAPS"></a><span class="term"><code class="literal">ATK_ROLE_PASSWORD_TEXT</code></span></p></td>
<td> A text object uses for passwords, or other places where the text content is not shown visibly to the user
</td>
</tr>
<tr>
<td><p><a name="ATK-ROLE-POPUP-MENU:CAPS"></a><span class="term"><code class="literal">ATK_ROLE_POPUP_MENU</code></span></p></td>
<td> A temporary window that is usually used to offer the user a list of choices, and then hides when the user selects one of those choices
</td>
</tr>
<tr>
<td><p><a name="ATK-ROLE-PROGRESS-BAR:CAPS"></a><span class="term"><code class="literal">ATK_ROLE_PROGRESS_BAR</code></span></p></td>
<td> An object used to indicate how much of a task has been completed
</td>
</tr>
<tr>
<td><p><a name="ATK-ROLE-PUSH-BUTTON:CAPS"></a><span class="term"><code class="literal">ATK_ROLE_PUSH_BUTTON</code></span></p></td>
<td> An object the user can manipulate to tell the application to do something
</td>
</tr>
<tr>
<td><p><a name="ATK-ROLE-RADIO-BUTTON:CAPS"></a><span class="term"><code class="literal">ATK_ROLE_RADIO_BUTTON</code></span></p></td>
<td> A specialized check box that will cause other radio buttons in the same group to become unchecked when this one is checked
</td>
</tr>
<tr>
<td><p><a name="ATK-ROLE-RADIO-MENU-ITEM:CAPS"></a><span class="term"><code class="literal">ATK_ROLE_RADIO_MENU_ITEM</code></span></p></td>
<td> A check menu item which belongs to a group. At each instant exactly one of the radio menu items from a group is selected
</td>
</tr>
<tr>
<td><p><a name="ATK-ROLE-ROOT-PANE:CAPS"></a><span class="term"><code class="literal">ATK_ROLE_ROOT_PANE</code></span></p></td>
<td> A specialized pane that has a glass pane and a layered pane as its children
</td>
</tr>
<tr>
<td><p><a name="ATK-ROLE-ROW-HEADER:CAPS"></a><span class="term"><code class="literal">ATK_ROLE_ROW_HEADER</code></span></p></td>
<td> The header for a row of data
</td>
</tr>
<tr>
<td><p><a name="ATK-ROLE-SCROLL-BAR:CAPS"></a><span class="term"><code class="literal">ATK_ROLE_SCROLL_BAR</code></span></p></td>
<td> An object usually used to allow a user to incrementally view a large amount of data.
</td>
</tr>
<tr>
<td><p><a name="ATK-ROLE-SCROLL-PANE:CAPS"></a><span class="term"><code class="literal">ATK_ROLE_SCROLL_PANE</code></span></p></td>
<td> An object that allows a user to incrementally view a large amount of information
</td>
</tr>
<tr>
<td><p><a name="ATK-ROLE-SEPARATOR:CAPS"></a><span class="term"><code class="literal">ATK_ROLE_SEPARATOR</code></span></p></td>
<td> An object usually contained in a menu to provide a visible and logical separation of the contents in a menu
</td>
</tr>
<tr>
<td><p><a name="ATK-ROLE-SLIDER:CAPS"></a><span class="term"><code class="literal">ATK_ROLE_SLIDER</code></span></p></td>
<td> An object that allows the user to select from a bounded range
</td>
</tr>
<tr>
<td><p><a name="ATK-ROLE-SPLIT-PANE:CAPS"></a><span class="term"><code class="literal">ATK_ROLE_SPLIT_PANE</code></span></p></td>
<td> A specialized panel that presents two other panels at the same time
</td>
</tr>
<tr>
<td><p><a name="ATK-ROLE-SPIN-BUTTON:CAPS"></a><span class="term"><code class="literal">ATK_ROLE_SPIN_BUTTON</code></span></p></td>
<td> An object used to get an integer or floating point number from the user
</td>
</tr>
<tr>
<td><p><a name="ATK-ROLE-STATUSBAR:CAPS"></a><span class="term"><code class="literal">ATK_ROLE_STATUSBAR</code></span></p></td>
<td> An object which reports messages of minor importance to the user
</td>
</tr>
<tr>
<td><p><a name="ATK-ROLE-TABLE:CAPS"></a><span class="term"><code class="literal">ATK_ROLE_TABLE</code></span></p></td>
<td> An object used to represent information in terms of rows and columns
</td>
</tr>
<tr>
<td><p><a name="ATK-ROLE-TABLE-CELL:CAPS"></a><span class="term"><code class="literal">ATK_ROLE_TABLE_CELL</code></span></p></td>
<td> A cell in a table
</td>
</tr>
<tr>
<td><p><a name="ATK-ROLE-TABLE-COLUMN-HEADER:CAPS"></a><span class="term"><code class="literal">ATK_ROLE_TABLE_COLUMN_HEADER</code></span></p></td>
<td> The header for a column of a table
</td>
</tr>
<tr>
<td><p><a name="ATK-ROLE-TABLE-ROW-HEADER:CAPS"></a><span class="term"><code class="literal">ATK_ROLE_TABLE_ROW_HEADER</code></span></p></td>
<td> The header for a row of a table
</td>
</tr>
<tr>
<td><p><a name="ATK-ROLE-TEAR-OFF-MENU-ITEM:CAPS"></a><span class="term"><code class="literal">ATK_ROLE_TEAR_OFF_MENU_ITEM</code></span></p></td>
<td> A menu item used to tear off and reattach its menu
</td>
</tr>
<tr>
<td><p><a name="ATK-ROLE-TERMINAL:CAPS"></a><span class="term"><code class="literal">ATK_ROLE_TERMINAL</code></span></p></td>
<td> An object that represents an accessible terminal.  <em class="parameter"><code>Since</code></em>: ATK-0.6
</td>
</tr>
<tr>
<td><p><a name="ATK-ROLE-TEXT:CAPS"></a><span class="term"><code class="literal">ATK_ROLE_TEXT</code></span></p></td>
<td> An object that presents text to the user
</td>
</tr>
<tr>
<td><p><a name="ATK-ROLE-TOGGLE-BUTTON:CAPS"></a><span class="term"><code class="literal">ATK_ROLE_TOGGLE_BUTTON</code></span></p></td>
<td> A specialized push button that can be checked or unchecked, but does not provide a separate indicator for the current state
</td>
</tr>
<tr>
<td><p><a name="ATK-ROLE-TOOL-BAR:CAPS"></a><span class="term"><code class="literal">ATK_ROLE_TOOL_BAR</code></span></p></td>
<td> A bar or palette usually composed of push buttons or toggle buttons
</td>
</tr>
<tr>
<td><p><a name="ATK-ROLE-TOOL-TIP:CAPS"></a><span class="term"><code class="literal">ATK_ROLE_TOOL_TIP</code></span></p></td>
<td> An object that provides information about another object
</td>
</tr>
<tr>
<td><p><a name="ATK-ROLE-TREE:CAPS"></a><span class="term"><code class="literal">ATK_ROLE_TREE</code></span></p></td>
<td> An object used to represent hierarchical information to the user
</td>
</tr>
<tr>
<td><p><a name="ATK-ROLE-TREE-TABLE:CAPS"></a><span class="term"><code class="literal">ATK_ROLE_TREE_TABLE</code></span></p></td>
<td> An object capable of expanding and collapsing rows as well as showing multiple columns of data.   <em class="parameter"><code>Since</code></em>: ATK-0.7
</td>
</tr>
<tr>
<td><p><a name="ATK-ROLE-UNKNOWN:CAPS"></a><span class="term"><code class="literal">ATK_ROLE_UNKNOWN</code></span></p></td>
<td> The object contains some Accessible information, but its role is not known
</td>
</tr>
<tr>
<td><p><a name="ATK-ROLE-VIEWPORT:CAPS"></a><span class="term"><code class="literal">ATK_ROLE_VIEWPORT</code></span></p></td>
<td> An object usually used in a scroll pane
</td>
</tr>
<tr>
<td><p><a name="ATK-ROLE-WINDOW:CAPS"></a><span class="term"><code class="literal">ATK_ROLE_WINDOW</code></span></p></td>
<td> A top level window with no title or border.
</td>
</tr>
<tr>
<td><p><a name="ATK-ROLE-HEADER:CAPS"></a><span class="term"><code class="literal">ATK_ROLE_HEADER</code></span></p></td>
<td> An object that serves as a document header. <em class="parameter"><code>Since</code></em>:ATK 1.1.1
</td>
</tr>
<tr>
<td><p><a name="ATK-ROLE-FOOTER:CAPS"></a><span class="term"><code class="literal">ATK_ROLE_FOOTER</code></span></p></td>
<td> An object that serves as a document footer.  <em class="parameter"><code>Since</code></em>: ATK-1.1.1
</td>
</tr>
<tr>
<td><p><a name="ATK-ROLE-PARAGRAPH:CAPS"></a><span class="term"><code class="literal">ATK_ROLE_PARAGRAPH</code></span></p></td>
<td> An object which is contains a paragraph of text content.   <em class="parameter"><code>Since</code></em>: ATK-1.1.1
</td>
</tr>
<tr>
<td><p><a name="ATK-ROLE-RULER:CAPS"></a><span class="term"><code class="literal">ATK_ROLE_RULER</code></span></p></td>
<td> An object which describes margins and tab stops, etc. for text objects which it controls (should have CONTROLLER_FOR relation to such).   <em class="parameter"><code>Since</code></em>: ATK-1.1.1
</td>
</tr>
<tr>
<td><p><a name="ATK-ROLE-APPLICATION:CAPS"></a><span class="term"><code class="literal">ATK_ROLE_APPLICATION</code></span></p></td>
<td> The object is an application object, which may contain <em class="parameter"><code>ATK_ROLE_FRAME</code></em> objects or other types of accessibles.  The root accessible of any application's ATK hierarchy should have ATK_ROLE_APPLICATION.   <em class="parameter"><code>Since</code></em>: ATK-1.1.4
</td>
</tr>
<tr>
<td><p><a name="ATK-ROLE-AUTOCOMPLETE:CAPS"></a><span class="term"><code class="literal">ATK_ROLE_AUTOCOMPLETE</code></span></p></td>
<td> The object is a dialog or list containing items for insertion into an entry widget, for instance a list of words for completion of a text entry.   <em class="parameter"><code>Since</code></em>: ATK-1.3
</td>
</tr>
<tr>
<td><p><a name="ATK-ROLE-EDITBAR:CAPS"></a><span class="term"><code class="literal">ATK_ROLE_EDITBAR</code></span></p></td>
<td> The object is an editable text object in a toolbar.  <em class="parameter"><code>Since</code></em>: ATK-1.5
</td>
</tr>
<tr>
<td><p><a name="ATK-ROLE-EMBEDDED:CAPS"></a><span class="term"><code class="literal">ATK_ROLE_EMBEDDED</code></span></p></td>
<td> The object is an embedded container within a document or panel.  This role is a grouping "hint" indicating that the contained objects share a context.  <em class="parameter"><code>Since</code></em>: ATK-1.7.2
</td>
</tr>
<tr>
<td><p><a name="ATK-ROLE-ENTRY:CAPS"></a><span class="term"><code class="literal">ATK_ROLE_ENTRY</code></span></p></td>
<td> The object is a component whose textual content may be entered or modified by the user, provided <em class="parameter"><code>ATK_STATE_EDITABLE</code></em> is present.   <em class="parameter"><code>Since</code></em>: ATK-1.11
</td>
</tr>
<tr>
<td><p><a name="ATK-ROLE-CHART:CAPS"></a><span class="term"><code class="literal">ATK_ROLE_CHART</code></span></p></td>
<td> The object is a graphical depiction of quantitative data. It may contain multiple subelements whose attributes and/or description may be queried to obtain both the quantitative data and information about how the data is being presented. The LABELLED_BY relation is particularly important in interpreting objects of this type, as is the accessible-description property.  <em class="parameter"><code>Since</code></em>: ATK-1.11
</td>
</tr>
<tr>
<td><p><a name="ATK-ROLE-CAPTION:CAPS"></a><span class="term"><code class="literal">ATK_ROLE_CAPTION</code></span></p></td>
<td> The object contains descriptive information, usually textual, about another user interface element such as a table, chart, or image.  <em class="parameter"><code>Since</code></em>: ATK-1.11
</td>
</tr>
<tr>
<td><p><a name="ATK-ROLE-DOCUMENT-FRAME:CAPS"></a><span class="term"><code class="literal">ATK_ROLE_DOCUMENT_FRAME</code></span></p></td>
<td> The object is a visual frame or container which contains a view of document content. Document frames may occur within another Document instance, in which case the second document may be said to be embedded in the containing instance. HTML frames are often ROLE_DOCUMENT_FRAME. Either this object, or a singleton descendant, should implement the Document interface.  <em class="parameter"><code>Since</code></em>: ATK-1.11
</td>
</tr>
<tr>
<td><p><a name="ATK-ROLE-HEADING:CAPS"></a><span class="term"><code class="literal">ATK_ROLE_HEADING</code></span></p></td>
<td> The object serves as a heading for content which follows it in a document. The 'heading level' of the heading, if availabe, may be obtained by querying the object's attributes.
</td>
</tr>
<tr>
<td><p><a name="ATK-ROLE-PAGE:CAPS"></a><span class="term"><code class="literal">ATK_ROLE_PAGE</code></span></p></td>
<td> The object is a containing instance which encapsulates a page of information. <em class="parameter"><code>ATK_ROLE_PAGE</code></em> is used in documents and content which support a paginated navigation model.  <em class="parameter"><code>Since</code></em>: ATK-1.11
</td>
</tr>
<tr>
<td><p><a name="ATK-ROLE-SECTION:CAPS"></a><span class="term"><code class="literal">ATK_ROLE_SECTION</code></span></p></td>
<td> The object is a containing instance of document content which constitutes a particular 'logical' section of the document. The type of content within a section, and the nature of the section division itself, may be obtained by querying the object's attributes. Sections may be nested. <em class="parameter"><code>Since</code></em>: ATK-1.11
</td>
</tr>
<tr>
<td><p><a name="ATK-ROLE-REDUNDANT-OBJECT:CAPS"></a><span class="term"><code class="literal">ATK_ROLE_REDUNDANT_OBJECT</code></span></p></td>
<td> The object is redundant with another object in the hierarchy, and is exposed for purely technical reasons.  Objects of this role should normally be ignored by clients. <em class="parameter"><code>Since</code></em>: ATK-1.11
</td>
</tr>
<tr>
<td><p><a name="ATK-ROLE-FORM:CAPS"></a><span class="term"><code class="literal">ATK_ROLE_FORM</code></span></p></td>
<td> The object is a container for form controls, for instance as part of a 
web form or user-input form within a document.  This role is primarily a tag/convenience for 
clients when navigating complex documents, it is not expected that ordinary GUI containers will 
always have ATK_ROLE_FORM. <em class="parameter"><code>Since</code></em>: ATK-1.12.0
</td>
</tr>
<tr>
<td><p><a name="ATK-ROLE-LINK:CAPS"></a><span class="term"><code class="literal">ATK_ROLE_LINK</code></span></p></td>
<td> The object is a hypertext anchor, i.e. a "link" in a
hypertext document.  Such objects are distinct from 'inline'
content which may also use the Hypertext/Hyperlink interfaces
to indicate the range/location within a text object where
an inline or embedded object lies.  <em class="parameter"><code>Since</code></em>: ATK-1.12.1
</td>
</tr>
<tr>
<td><p><a name="ATK-ROLE-INPUT-METHOD-WINDOW:CAPS"></a><span class="term"><code class="literal">ATK_ROLE_INPUT_METHOD_WINDOW</code></span></p></td>
<td> The object is a window or similar viewport 
which is used to allow composition or input of a 'complex character',
in other words it is an "input method window." <em class="parameter"><code>Since</code></em>: ATK-1.12.1
</td>
</tr>
<tr>
<td><p><a name="ATK-ROLE-LAST-DEFINED:CAPS"></a><span class="term"><code class="literal">ATK_ROLE_LAST_DEFINED</code></span></p></td>
<td> not a valid role, used for finding end of the enumeration
</td>
</tr>
</tbody>
</table></div>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="atk-role-register"></a><h3>atk_role_register ()</h3>
<pre class="programlisting"><a class="link" href="AtkObject.html#AtkRole" title="enum AtkRole">AtkRole</a>             atk_role_register                   (const <a
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gchar"
>gchar</a> *name);</pre>
<p>
Registers the role specified by <em class="parameter"><code>name</code></em>.</p>
<p>

</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td><p><span class="term"><em class="parameter"><code>name</code></em> :</span></p></td>
<td> a character string describing the new role.
</td>
</tr>
<tr>
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
<td> an <a class="link" href="AtkObject.html#AtkRole" title="enum AtkRole"><span class="type">AtkRole</span></a> for the new role.
</td>
</tr>
</tbody>
</table></div>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="AtkLayer"></a><h3>enum AtkLayer</h3>
<pre class="programlisting">typedef enum
{
  ATK_LAYER_INVALID,
  ATK_LAYER_BACKGROUND,
  ATK_LAYER_CANVAS,
  ATK_LAYER_WIDGET,
  ATK_LAYER_MDI,
  ATK_LAYER_POPUP,
  ATK_LAYER_OVERLAY,
  ATK_LAYER_WINDOW
} AtkLayer;
</pre>
<p>
Describes the layer of a component
</p>
<p>
These enumerated "layer values" are used when determining which UI
rendering layer a component is drawn into, which can help in making
determinations of when components occlude one another.</p>
<p>
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td><p><a name="ATK-LAYER-INVALID:CAPS"></a><span class="term"><code class="literal">ATK_LAYER_INVALID</code></span></p></td>
<td> The object does not have a layer
</td>
</tr>
<tr>
<td><p><a name="ATK-LAYER-BACKGROUND:CAPS"></a><span class="term"><code class="literal">ATK_LAYER_BACKGROUND</code></span></p></td>
<td> This layer is reserved for the desktop background
</td>
</tr>
<tr>
<td><p><a name="ATK-LAYER-CANVAS:CAPS"></a><span class="term"><code class="literal">ATK_LAYER_CANVAS</code></span></p></td>
<td> This layer is used for Canvas components
</td>
</tr>
<tr>
<td><p><a name="ATK-LAYER-WIDGET:CAPS"></a><span class="term"><code class="literal">ATK_LAYER_WIDGET</code></span></p></td>
<td> This layer is normally used for components
</td>
</tr>
<tr>
<td><p><a name="ATK-LAYER-MDI:CAPS"></a><span class="term"><code class="literal">ATK_LAYER_MDI</code></span></p></td>
<td> This layer is used for layered components
</td>
</tr>
<tr>
<td><p><a name="ATK-LAYER-POPUP:CAPS"></a><span class="term"><code class="literal">ATK_LAYER_POPUP</code></span></p></td>
<td> This layer is used for popup components, such as menus
</td>
</tr>
<tr>
<td><p><a name="ATK-LAYER-OVERLAY:CAPS"></a><span class="term"><code class="literal">ATK_LAYER_OVERLAY</code></span></p></td>
<td> This layer is reserved for future use.
</td>
</tr>
<tr>
<td><p><a name="ATK-LAYER-WINDOW:CAPS"></a><span class="term"><code class="literal">ATK_LAYER_WINDOW</code></span></p></td>
<td> This layer is used for toplevel windows.
</td>
</tr>
</tbody>
</table></div>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="AtkImplementor"></a><h3>AtkImplementor</h3>
<pre class="programlisting">typedef struct _AtkImplementor AtkImplementor;</pre>
<p>
The AtkImplementor interface is implemented by objects for which AtkObject peers may be obtained via calls to iface-&gt;(ref_accessible)(implementor);
</p>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="AtkPropertyValues"></a><h3>AtkPropertyValues</h3>
<pre class="programlisting">typedef struct {
  const gchar  *property_name;
  GValue old_value;
  GValue new_value;
} AtkPropertyValues;
</pre>
<p>
<em class="parameter"><code>note</code></em>: For most properties the old_value field of AtkPropertyValues will
not contain a valid value.
</p>
<p>
Currently, the only property for which old_value is used is
accessible-state; for instance if there is a focus state the
property change handler will be called for the object which lost the focus
with the old_value containing an AtkState value corresponding to focused
and the property change handler will be called for the object which
received the focus with the new_value containing an AtkState value
corresponding to focused.</p>
<p>
The Atk PropertyValue structure is used when notifying a change in property.
Currently, the only property for which old_value is used is
accessible-state; for instance if there is a focus change the
property change handler will be called for the object which lost the focus
with the old_value containing the AtkState value corresponding to focused
and the property change handler will be called for the object which
received the focus with the new_value containing the AtkState value
corresponding to focused.

</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td><p><span class="term">const <a
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gchar"
>gchar</a> *<em class="structfield"><code>property_name</code></em>;</span></p></td>
<td> The name of the ATK property which is being presented or which has been changed.
</td>
</tr>
<tr>
<td><p><span class="term"><a
href="/usr/share/gtk-doc/html/gobject/gobject-Generic-values.html#GValue"
>GValue</a> <em class="structfield"><code>old_value</code></em>;</span></p></td>
<td> The old property value, NULL; in some contexts this value is undefined (see note below).
</td>
</tr>
<tr>
<td><p><span class="term"><a
href="/usr/share/gtk-doc/html/gobject/gobject-Generic-values.html#GValue"
>GValue</a> <em class="structfield"><code>new_value</code></em>;</span></p></td>
<td> The new value of the named property.
</td>
</tr>
</tbody>
</table></div>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="AtkFunction"></a><h3>AtkFunction ()</h3>
<pre class="programlisting"><a
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gboolean"
>gboolean</a>            (*AtkFunction)                      (<a
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gpointer"
>gpointer</a> data);</pre>
<p>
An AtkFunction is a function definition used for padding which has been added 
to class and interface structures to allow for expansion in the future.

</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td><p><span class="term"><em class="parameter"><code>data</code></em> :</span></p></td>
<td>a gpointer to parameter data.
</td>
</tr>
<tr>
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
<td>Nothing useful, this is only a dummy prototype.


</td>
</tr>
</tbody>
</table></div>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="AtkPropertyChangeHandler"></a><h3>AtkPropertyChangeHandler ()</h3>
<pre class="programlisting">void                (*AtkPropertyChangeHandler)         (<a class="link" href="AtkObject.html" title="AtkObject">AtkObject</a> *,
                                                         <a class="link" href="AtkObject.html#AtkPropertyValues" title="AtkPropertyValues">AtkPropertyValues</a> *);</pre>
<p>
An AtkPropertyChangeHandler is a function which is executed when an AtkObject's property changes value. It is specified in a call to 
<a class="link" href="AtkObject.html#atk-object-connect-property-change-handler" title="atk_object_connect_property_change_handler ()"><code class="function">atk_object_connect_property_change_handler()</code></a>.
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td><p><span class="term"><em class="parameter"><code>Param1</code></em> :</span></p></td>
<td> an <a class="link" href="AtkObject.html" title="AtkObject"><span class="type">AtkObject</span></a>
</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>Param2</code></em> :</span></p></td>
<td> an <a class="link" href="AtkObject.html#AtkPropertyValues" title="AtkPropertyValues"><span class="type">AtkPropertyValues</span></a>


</td>
</tr>
</tbody>
</table></div>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="atk-implementor-ref-accessible"></a><h3>atk_implementor_ref_accessible ()</h3>
<pre class="programlisting"><a class="link" href="AtkObject.html" title="AtkObject">AtkObject</a>*          atk_implementor_ref_accessible      (<a class="link" href="AtkObject.html#AtkImplementor" title="AtkImplementor">AtkImplementor</a> *implementor);</pre>
<p>
Gets a reference to an object's <a class="link" href="AtkObject.html" title="AtkObject"><span class="type">AtkObject</span></a> implementation, if
the object implements <span class="type">AtkObjectIface</span></p>
<p>

</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td><p><span class="term"><em class="parameter"><code>implementor</code></em> :</span></p></td>
<td> The <a
href="/usr/share/gtk-doc/html/gobject/gobject-The-Base-Object-Type.html#GObject"
><span class="type">GObject</span></a> instance which should implement <span class="type">AtkImplementorIface</span>
if a non-null return value is required.
</td>
</tr>
<tr>
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
<td> a reference to an object's <a class="link" href="AtkObject.html" title="AtkObject"><span class="type">AtkObject</span></a> implementation
</td>
</tr>
</tbody>
</table></div>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="atk-object-get-name"></a><h3>atk_object_get_name ()</h3>
<pre class="programlisting">const <a
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gchar"
>gchar</a>*        atk_object_get_name                 (<a class="link" href="AtkObject.html" title="AtkObject">AtkObject</a> *accessible);</pre>
<p>
Gets the accessible name of the accessible.</p>
<p>

</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td><p><span class="term"><em class="parameter"><code>accessible</code></em> :</span></p></td>
<td> an <a class="link" href="AtkObject.html" title="AtkObject"><span class="type">AtkObject</span></a>
</td>
</tr>
<tr>
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
<td> a character string representing the accessible name of the object.
</td>
</tr>
</tbody>
</table></div>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="atk-object-get-description"></a><h3>atk_object_get_description ()</h3>
<pre class="programlisting">const <a
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gchar"
>gchar</a>*        atk_object_get_description          (<a class="link" href="AtkObject.html" title="AtkObject">AtkObject</a> *accessible);</pre>
<p>
Gets the accessible description of the accessible.</p>
<p>

</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td><p><span class="term"><em class="parameter"><code>accessible</code></em> :</span></p></td>
<td> an <a class="link" href="AtkObject.html" title="AtkObject"><span class="type">AtkObject</span></a>
</td>
</tr>
<tr>
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
<td> a character string representing the accessible description
of the accessible.

</td>
</tr>
</tbody>
</table></div>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="atk-object-get-parent"></a><h3>atk_object_get_parent ()</h3>
<pre class="programlisting"><a class="link" href="AtkObject.html" title="AtkObject">AtkObject</a>*          atk_object_get_parent               (<a class="link" href="AtkObject.html" title="AtkObject">AtkObject</a> *accessible);</pre>
<p>
Gets the accessible parent of the accessible.</p>
<p>

</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td><p><span class="term"><em class="parameter"><code>accessible</code></em> :</span></p></td>
<td> an <a class="link" href="AtkObject.html" title="AtkObject"><span class="type">AtkObject</span></a>
</td>
</tr>
<tr>
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
<td> a <a class="link" href="AtkObject.html" title="AtkObject"><span class="type">AtkObject</span></a> representing the accessible parent of the accessible
</td>
</tr>
</tbody>
</table></div>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="atk-object-get-n-accessible-children"></a><h3>atk_object_get_n_accessible_children ()</h3>
<pre class="programlisting"><a
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gint"
>gint</a>                atk_object_get_n_accessible_children
                                                        (<a class="link" href="AtkObject.html" title="AtkObject">AtkObject</a> *accessible);</pre>
<p>
Gets the number of accessible children of the accessible.</p>
<p>

</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td><p><span class="term"><em class="parameter"><code>accessible</code></em> :</span></p></td>
<td> an <a class="link" href="AtkObject.html" title="AtkObject"><span class="type">AtkObject</span></a>
</td>
</tr>
<tr>
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
<td> an integer representing the number of accessible children
of the accessible.
</td>
</tr>
</tbody>
</table></div>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="atk-object-ref-accessible-child"></a><h3>atk_object_ref_accessible_child ()</h3>
<pre class="programlisting"><a class="link" href="AtkObject.html" title="AtkObject">AtkObject</a>*          atk_object_ref_accessible_child     (<a class="link" href="AtkObject.html" title="AtkObject">AtkObject</a> *accessible,
                                                         <a
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gint"
>gint</a> i);</pre>
<p>
Gets a reference to the specified accessible child of the object.
The accessible children are 0-based so the first accessible child is
at index 0, the second at index 1 and so on.</p>
<p>

</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td><p><span class="term"><em class="parameter"><code>accessible</code></em> :</span></p></td>
<td> an <a class="link" href="AtkObject.html" title="AtkObject"><span class="type">AtkObject</span></a>
</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>i</code></em> :</span></p></td>
<td> a gint representing the position of the child, starting from 0
</td>
</tr>
<tr>
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
<td> an <a class="link" href="AtkObject.html" title="AtkObject"><span class="type">AtkObject</span></a> representing the specified accessible child
of the accessible.
</td>
</tr>
</tbody>
</table></div>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="atk-object-ref-relation-set"></a><h3>atk_object_ref_relation_set ()</h3>
<pre class="programlisting"><a class="link" href="AtkRelationSet.html" title="AtkRelationSet">AtkRelationSet</a>*     atk_object_ref_relation_set         (<a class="link" href="AtkObject.html" title="AtkObject">AtkObject</a> *accessible);</pre>
<p>
Gets the <a class="link" href="AtkRelationSet.html" title="AtkRelationSet"><span class="type">AtkRelationSet</span></a> associated with the object.</p>
<p>

</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td><p><span class="term"><em class="parameter"><code>accessible</code></em> :</span></p></td>
<td> an <a class="link" href="AtkObject.html" title="AtkObject"><span class="type">AtkObject</span></a>
</td>
</tr>
<tr>
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
<td> an <a class="link" href="AtkRelationSet.html" title="AtkRelationSet"><span class="type">AtkRelationSet</span></a> representing the relation set of the object.
</td>
</tr>
</tbody>
</table></div>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="atk-object-get-layer"></a><h3>atk_object_get_layer ()</h3>
<pre class="programlisting"><a class="link" href="AtkObject.html#AtkLayer" title="enum AtkLayer">AtkLayer</a>            atk_object_get_layer                (<a class="link" href="AtkObject.html" title="AtkObject">AtkObject</a> *accessible);</pre>
<div class="warning" style="margin-left: 0.5in; margin-right: 0.5in;">
<h3 class="title">Warning</h3>
<p><code class="literal">atk_object_get_layer</code> is deprecated and should not be used in newly-written code. Use atk_component_get_layer instead.</p>
</div>
<p>
Gets the layer of the accessible.</p>
<p>

</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td><p><span class="term"><em class="parameter"><code>accessible</code></em> :</span></p></td>
<td> an <a class="link" href="AtkObject.html" title="AtkObject"><span class="type">AtkObject</span></a>
</td>
</tr>
<tr>
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
<td> an <a class="link" href="AtkObject.html#AtkLayer" title="enum AtkLayer"><span class="type">AtkLayer</span></a> which is the layer of the accessible
</td>
</tr>
</tbody>
</table></div>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="atk-object-get-mdi-zorder"></a><h3>atk_object_get_mdi_zorder ()</h3>
<pre class="programlisting"><a
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gint"
>gint</a>                atk_object_get_mdi_zorder           (<a class="link" href="AtkObject.html" title="AtkObject">AtkObject</a> *accessible);</pre>
<div class="warning" style="margin-left: 0.5in; margin-right: 0.5in;">
<h3 class="title">Warning</h3>
<p><code class="literal">atk_object_get_mdi_zorder</code> is deprecated and should not be used in newly-written code. Use atk_component_get_mdi_zorder instead.</p>
</div>
<p>
Gets the zorder of the accessible. The value G_MININT will be returned 
if the layer of the accessible is not ATK_LAYER_MDI.</p>
<p>

</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td><p><span class="term"><em class="parameter"><code>accessible</code></em> :</span></p></td>
<td> an <a class="link" href="AtkObject.html" title="AtkObject"><span class="type">AtkObject</span></a>
</td>
</tr>
<tr>
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
<td> a gint which is the zorder of the accessible, i.e. the depth at 
which the component is shown in relation to other components in the same 
container.

</td>
</tr>
</tbody>
</table></div>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="atk-object-get-role"></a><h3>atk_object_get_role ()</h3>
<pre class="programlisting"><a class="link" href="AtkObject.html#AtkRole" title="enum AtkRole">AtkRole</a>             atk_object_get_role                 (<a class="link" href="AtkObject.html" title="AtkObject">AtkObject</a> *accessible);</pre>
<p>
Gets the role of the accessible.</p>
<p>

</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td><p><span class="term"><em class="parameter"><code>accessible</code></em> :</span></p></td>
<td> an <a class="link" href="AtkObject.html" title="AtkObject"><span class="type">AtkObject</span></a>
</td>
</tr>
<tr>
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
<td> an <a class="link" href="AtkObject.html#AtkRole" title="enum AtkRole"><span class="type">AtkRole</span></a> which is the role of the accessible
</td>
</tr>
</tbody>
</table></div>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="atk-object-ref-state-set"></a><h3>atk_object_ref_state_set ()</h3>
<pre class="programlisting">AtkStateSet*        atk_object_ref_state_set            (<a class="link" href="AtkObject.html" title="AtkObject">AtkObject</a> *accessible);</pre>
<p>
Gets a reference to the state set of the accessible; the caller must
unreference it when it is no longer needed.</p>
<p>

</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td><p><span class="term"><em class="parameter"><code>accessible</code></em> :</span></p></td>
<td> an <a class="link" href="AtkObject.html" title="AtkObject"><span class="type">AtkObject</span></a>
</td>
</tr>
<tr>
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
<td> a reference to an <span class="type">AtkStateSet</span> which is the state
set of the accessible
</td>
</tr>
</tbody>
</table></div>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="atk-object-get-index-in-parent"></a><h3>atk_object_get_index_in_parent ()</h3>
<pre class="programlisting"><a
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gint"
>gint</a>                atk_object_get_index_in_parent      (<a class="link" href="AtkObject.html" title="AtkObject">AtkObject</a> *accessible);</pre>
<p>
Gets the 0-based index of this accessible in its parent; returns -1 if the
accessible does not have an accessible parent.</p>
<p>

</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td><p><span class="term"><em class="parameter"><code>accessible</code></em> :</span></p></td>
<td> an <a class="link" href="AtkObject.html" title="AtkObject"><span class="type">AtkObject</span></a>
</td>
</tr>
<tr>
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
<td> an integer which is the index of the accessible in its parent
</td>
</tr>
</tbody>
</table></div>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="atk-object-set-name"></a><h3>atk_object_set_name ()</h3>
<pre class="programlisting">void                atk_object_set_name                 (<a class="link" href="AtkObject.html" title="AtkObject">AtkObject</a> *accessible,
                                                         const <a
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gchar"
>gchar</a> *name);</pre>
<p>
Sets the accessible name of the accessible.</p>
<p>

</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td><p><span class="term"><em class="parameter"><code>accessible</code></em> :</span></p></td>
<td> an <a class="link" href="AtkObject.html" title="AtkObject"><span class="type">AtkObject</span></a>
</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>name</code></em> :</span></p></td>
<td> a character string to be set as the accessible name
</td>
</tr>
</tbody>
</table></div>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="atk-object-set-description"></a><h3>atk_object_set_description ()</h3>
<pre class="programlisting">void                atk_object_set_description          (<a class="link" href="AtkObject.html" title="AtkObject">AtkObject</a> *accessible,
                                                         const <a
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gchar"
>gchar</a> *description);</pre>
<p>
Sets the accessible description of the accessible.</p>
<p>

</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td><p><span class="term"><em class="parameter"><code>accessible</code></em> :</span></p></td>
<td> an <a class="link" href="AtkObject.html" title="AtkObject"><span class="type">AtkObject</span></a>
</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>description</code></em> :</span></p></td>
<td> a character string to be set as the accessible description
</td>
</tr>
</tbody>
</table></div>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="atk-object-set-parent"></a><h3>atk_object_set_parent ()</h3>
<pre class="programlisting">void                atk_object_set_parent               (<a class="link" href="AtkObject.html" title="AtkObject">AtkObject</a> *accessible,
                                                         <a class="link" href="AtkObject.html" title="AtkObject">AtkObject</a> *parent);</pre>
<p>
Sets the accessible parent of the accessible.</p>
<p>

</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td><p><span class="term"><em class="parameter"><code>accessible</code></em> :</span></p></td>
<td> an <a class="link" href="AtkObject.html" title="AtkObject"><span class="type">AtkObject</span></a>
</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>parent</code></em> :</span></p></td>
<td> an <a class="link" href="AtkObject.html" title="AtkObject"><span class="type">AtkObject</span></a> to be set as the accessible parent
</td>
</tr>
</tbody>
</table></div>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="atk-object-set-role"></a><h3>atk_object_set_role ()</h3>
<pre class="programlisting">void                atk_object_set_role                 (<a class="link" href="AtkObject.html" title="AtkObject">AtkObject</a> *accessible,
                                                         <a class="link" href="AtkObject.html#AtkRole" title="enum AtkRole">AtkRole</a> role);</pre>
<p>
Sets the role of the accessible.</p>
<p>

</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td><p><span class="term"><em class="parameter"><code>accessible</code></em> :</span></p></td>
<td> an <a class="link" href="AtkObject.html" title="AtkObject"><span class="type">AtkObject</span></a>
</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>role</code></em> :</span></p></td>
<td> an <a class="link" href="AtkObject.html#AtkRole" title="enum AtkRole"><span class="type">AtkRole</span></a> to be set as the role
</td>
</tr>
</tbody>
</table></div>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="atk-object-connect-property-change-handler"></a><h3>atk_object_connect_property_change_handler ()</h3>
<pre class="programlisting"><a
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#guint"
>guint</a>               atk_object_connect_property_change_handler
                                                        (<a class="link" href="AtkObject.html" title="AtkObject">AtkObject</a> *accessible,
                                                         <a class="link" href="AtkObject.html#AtkPropertyChangeHandler" title="AtkPropertyChangeHandler ()">AtkPropertyChangeHandler</a> *handler);</pre>
<p>
Specifies a function to be called when a property changes value.</p>
<p>

</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td><p><span class="term"><em class="parameter"><code>accessible</code></em> :</span></p></td>
<td> an <a class="link" href="AtkObject.html" title="AtkObject"><span class="type">AtkObject</span></a>
</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>handler</code></em> :</span></p></td>
<td> a function to be called when a property changes its value
</td>
</tr>
<tr>
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
<td> a <a
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#guint"
><span class="type">guint</span></a> which is the handler id used in 
<a class="link" href="AtkObject.html#atk-object-remove-property-change-handler" title="atk_object_remove_property_change_handler ()"><code class="function">atk_object_remove_property_change_handler()</code></a>
</td>
</tr>
</tbody>
</table></div>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="atk-object-remove-property-change-handler"></a><h3>atk_object_remove_property_change_handler ()</h3>
<pre class="programlisting">void                atk_object_remove_property_change_handler
                                                        (<a class="link" href="AtkObject.html" title="AtkObject">AtkObject</a> *accessible,
                                                         <a
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#guint"
>guint</a> handler_id);</pre>
<p>
Removes a property change handler.</p>
<p>

</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td><p><span class="term"><em class="parameter"><code>accessible</code></em> :</span></p></td>
<td> an <a class="link" href="AtkObject.html" title="AtkObject"><span class="type">AtkObject</span></a>
</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>handler_id</code></em> :</span></p></td>
<td> a guint which identifies the handler to be removed.
</td>
</tr>
</tbody>
</table></div>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="atk-object-notify-state-change"></a><h3>atk_object_notify_state_change ()</h3>
<pre class="programlisting">void                atk_object_notify_state_change      (<a class="link" href="AtkObject.html" title="AtkObject">AtkObject</a> *accessible,
                                                         <a class="link" href="atk-AtkState.html#AtkState" title="AtkState">AtkState</a> state,
                                                         <a
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gboolean"
>gboolean</a> value);</pre>
<p>
Emits a state-change signal for the specified state.</p>
<p>

</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td><p><span class="term"><em class="parameter"><code>accessible</code></em> :</span></p></td>
<td> an <a class="link" href="AtkObject.html" title="AtkObject"><span class="type">AtkObject</span></a>
</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>state</code></em> :</span></p></td>
<td> an <a class="link" href="atk-AtkState.html#AtkState" title="AtkState"><span class="type">AtkState</span></a> whose state is changed
</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>value</code></em> :</span></p></td>
<td> a gboolean which indicates whether the state is being set on or off
</td>
</tr>
</tbody>
</table></div>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="atk-object-initialize"></a><h3>atk_object_initialize ()</h3>
<pre class="programlisting">void                atk_object_initialize               (<a class="link" href="AtkObject.html" title="AtkObject">AtkObject</a> *accessible,
                                                         <a
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gpointer"
>gpointer</a> data);</pre>
<p>
This function is called when implementing subclasses of <a class="link" href="AtkObject.html" title="AtkObject"><span class="type">AtkObject</span></a>.
It does initialization required for the new object. It is intended
that this function should called only in the ...<code class="function">_new()</code> functions used
to create an instance of a subclass of <a class="link" href="AtkObject.html" title="AtkObject"><span class="type">AtkObject</span></a></p>
<p>

</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td><p><span class="term"><em class="parameter"><code>accessible</code></em> :</span></p></td>
<td> a <a class="link" href="AtkObject.html" title="AtkObject"><span class="type">AtkObject</span></a>
</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>data</code></em> :</span></p></td>
<td> a <a
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gpointer"
><span class="type">gpointer</span></a> which identifies the object for which the AtkObject was created.
</td>
</tr>
</tbody>
</table></div>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="atk-object-add-relationship"></a><h3>atk_object_add_relationship ()</h3>
<pre class="programlisting"><a
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gboolean"
>gboolean</a>            atk_object_add_relationship         (<a class="link" href="AtkObject.html" title="AtkObject">AtkObject</a> *object,
                                                         <a class="link" href="AtkRelation.html#AtkRelationType" title="enum AtkRelationType">AtkRelationType</a> relationship,
                                                         <a class="link" href="AtkObject.html" title="AtkObject">AtkObject</a> *target);</pre>
<p>
Adds a relationship of the specified type with the specified target.</p>
<p>

</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td><p><span class="term"><em class="parameter"><code>object</code></em> :</span></p></td>
<td> The <a class="link" href="AtkObject.html" title="AtkObject"><span class="type">AtkObject</span></a> to which an AtkRelation is to be added. 
</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>relationship</code></em> :</span></p></td>
<td> The <a class="link" href="AtkRelation.html#AtkRelationType" title="enum AtkRelationType"><span class="type">AtkRelationType</span></a> of the relation
</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>target</code></em> :</span></p></td>
<td> The <a class="link" href="AtkObject.html" title="AtkObject"><span class="type">AtkObject</span></a> which is to be the target of the relation.
</td>
</tr>
<tr>
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
<td>TRUE if the relationship is added.
</td>
</tr>
</tbody>
</table></div>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="atk-object-remove-relationship"></a><h3>atk_object_remove_relationship ()</h3>
<pre class="programlisting"><a
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gboolean"
>gboolean</a>            atk_object_remove_relationship      (<a class="link" href="AtkObject.html" title="AtkObject">AtkObject</a> *object,
                                                         <a class="link" href="AtkRelation.html#AtkRelationType" title="enum AtkRelationType">AtkRelationType</a> relationship,
                                                         <a class="link" href="AtkObject.html" title="AtkObject">AtkObject</a> *target);</pre>
<p>
Removes a relationship of the specified type with the specified target.</p>
<p>

</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td><p><span class="term"><em class="parameter"><code>object</code></em> :</span></p></td>
<td> The <a class="link" href="AtkObject.html" title="AtkObject"><span class="type">AtkObject</span></a> from which an AtkRelation is to be removed. 
</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>relationship</code></em> :</span></p></td>
<td> The <a class="link" href="AtkRelation.html#AtkRelationType" title="enum AtkRelationType"><span class="type">AtkRelationType</span></a> of the relation
</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>target</code></em> :</span></p></td>
<td> The <a class="link" href="AtkObject.html" title="AtkObject"><span class="type">AtkObject</span></a> which is the target of the relation to be removed.
</td>
</tr>
<tr>
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
<td>TRUE if the relationship is removed.
</td>
</tr>
</tbody>
</table></div>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="atk-object-get-attributes"></a><h3>atk_object_get_attributes ()</h3>
<pre class="programlisting"><a class="link" href="AtkText.html#AtkAttributeSet" title="AtkAttributeSet">AtkAttributeSet</a>*    atk_object_get_attributes           (<a class="link" href="AtkObject.html" title="AtkObject">AtkObject</a> *accessible);</pre>
<p>
Get a list of properties applied to this object as a whole, as an <a class="link" href="AtkText.html#AtkAttributeSet" title="AtkAttributeSet"><span class="type">AtkAttributeSet</span></a> consisting of 
name-value pairs. As such these attributes may be considered weakly-typed properties or annotations, 
as distinct from strongly-typed object data available via other get/set methods.
Not all objects have explicit "name-value pair" <a class="link" href="AtkText.html#AtkAttributeSet" title="AtkAttributeSet"><span class="type">AtkAttributeSet</span></a> properties.</p>
<p>

</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td><p><span class="term"><em class="parameter"><code>accessible</code></em> :</span></p></td>
<td> An <a class="link" href="AtkObject.html" title="AtkObject"><span class="type">AtkObject</span></a>.
</td>
</tr>
<tr>
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
<td> an <a class="link" href="AtkText.html#AtkAttributeSet" title="AtkAttributeSet"><span class="type">AtkAttributeSet</span></a> consisting of all explicit properties/annotations applied to 
the object, or an empty set if the object has no name-value pair attributes assigned to it.
</td>
</tr>
</tbody>
</table></div>
<p class="since">Since  ATK 1.12

</p>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="atk-role-get-name"></a><h3>atk_role_get_name ()</h3>
<pre class="programlisting">const <a
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gchar"
>gchar</a>*        atk_role_get_name                   (<a class="link" href="AtkObject.html#AtkRole" title="enum AtkRole">AtkRole</a> role);</pre>
<p>
Gets the description string describing the <a class="link" href="AtkObject.html#AtkRole" title="enum AtkRole"><span class="type">AtkRole</span></a> <em class="parameter"><code>role</code></em>.</p>
<p>

</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td><p><span class="term"><em class="parameter"><code>role</code></em> :</span></p></td>
<td> The <a class="link" href="AtkObject.html#AtkRole" title="enum AtkRole"><span class="type">AtkRole</span></a> whose name is required
</td>
</tr>
<tr>
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
<td> the string describing the AtkRole
</td>
</tr>
</tbody>
</table></div>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="atk-role-get-localized-name"></a><h3>atk_role_get_localized_name ()</h3>
<pre class="programlisting">const <a
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gchar"
>gchar</a>*        atk_role_get_localized_name         (<a class="link" href="AtkObject.html#AtkRole" title="enum AtkRole">AtkRole</a> role);</pre>
<p>
Gets the localized description string describing the <a class="link" href="AtkObject.html#AtkRole" title="enum AtkRole"><span class="type">AtkRole</span></a> <em class="parameter"><code>role</code></em>.</p>
<p>

</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td><p><span class="term"><em class="parameter"><code>role</code></em> :</span></p></td>
<td> The <a class="link" href="AtkObject.html#AtkRole" title="enum AtkRole"><span class="type">AtkRole</span></a> whose localized name is required
</td>
</tr>
<tr>
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
<td> the localized string describing the AtkRole
</td>
</tr>
</tbody>
</table></div>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="atk-role-for-name"></a><h3>atk_role_for_name ()</h3>
<pre class="programlisting"><a class="link" href="AtkObject.html#AtkRole" title="enum AtkRole">AtkRole</a>             atk_role_for_name                   (const <a
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gchar"
>gchar</a> *name);</pre>
<p>
Get the <a class="link" href="AtkObject.html#AtkRole" title="enum AtkRole"><span class="type">AtkRole</span></a> type corresponding to a rolew name.</p>
<p>

</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td><p><span class="term"><em class="parameter"><code>name</code></em> :</span></p></td>
<td> a string which is the (non-localized) name of an ATK role.
</td>
</tr>
<tr>
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
<td> the <a class="link" href="AtkObject.html#AtkRole" title="enum AtkRole"><span class="type">AtkRole</span></a> enumerated type corresponding to the specified
name,
         or <a class="link" href="AtkObject.html#ATK-ROLE-INVALID:CAPS"><span class="type">ATK_ROLE_INVALID</span></a> if no matching role is found.
</td>
</tr>
</tbody>
</table></div>
</div>
</div>
<div class="refsect1" lang="en">
<a name="AtkObject.property-details"></a><h2>Property Details</h2>
<div class="refsect2" lang="en">
<a name="AtkObject--accessible-component-layer"></a><h3>The <code class="literal">"accessible-component-layer"</code> property</h3>
<pre class="programlisting">  "accessible-component-layer" <a
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gint"
>gint</a>                  : Read</pre>
<p>The accessible layer of this object.</p>
<p>Allowed values: &gt;= 0</p>
<p>Default value: 0</p>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="AtkObject--accessible-component-mdi-zorder"></a><h3>The <code class="literal">"accessible-component-mdi-zorder"</code> property</h3>
<pre class="programlisting">  "accessible-component-mdi-zorder" <a
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gint"
>gint</a>                  : Read</pre>
<p>The accessible MDI value of this object.</p>
<p>Default value: -2147483648</p>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="AtkObject--accessible-description"></a><h3>The <code class="literal">"accessible-description"</code> property</h3>
<pre class="programlisting">  "accessible-description"   <a
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gchar"
>gchar</a>*                : Read / Write</pre>
<p>Description of an object, formatted for assistive technology access.</p>
<p>Default value: NULL</p>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="AtkObject--accessible-hypertext-nlinks"></a><h3>The <code class="literal">"accessible-hypertext-nlinks"</code> property</h3>
<pre class="programlisting">  "accessible-hypertext-nlinks" <a
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gint"
>gint</a>                  : Read</pre>
<p>The number of links which the current AtkHypertext has.</p>
<p>Allowed values: &gt;= 0</p>
<p>Default value: 0</p>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="AtkObject--accessible-name"></a><h3>The <code class="literal">"accessible-name"</code> property</h3>
<pre class="programlisting">  "accessible-name"          <a
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gchar"
>gchar</a>*                : Read / Write</pre>
<p>Object instance's name formatted for assistive technology access.</p>
<p>Default value: NULL</p>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="AtkObject--accessible-parent"></a><h3>The <code class="literal">"accessible-parent"</code> property</h3>
<pre class="programlisting">  "accessible-parent"        <a class="link" href="AtkObject.html" title="AtkObject">AtkObject</a>*            : Read / Write</pre>
<p>Is used to notify that the parent has changed.</p>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="AtkObject--accessible-role"></a><h3>The <code class="literal">"accessible-role"</code> property</h3>
<pre class="programlisting">  "accessible-role"          <a
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gint"
>gint</a>                  : Read / Write</pre>
<p>The accessible role of this object.</p>
<p>Allowed values: &gt;= 0</p>
<p>Default value: 0</p>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="AtkObject--accessible-table-caption"></a><h3>The <code class="literal">"accessible-table-caption"</code> property</h3>
<pre class="programlisting">  "accessible-table-caption" <a
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gchar"
>gchar</a>*                : Read / Write</pre>
<p>Is used to notify that the table caption has changed; this property should not be used. accessible-table-caption-object should be used instead.</p>
<p>Default value: NULL</p>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="AtkObject--accessible-table-caption-object"></a><h3>The <code class="literal">"accessible-table-caption-object"</code> property</h3>
<pre class="programlisting">  "accessible-table-caption-object" <a class="link" href="AtkObject.html" title="AtkObject">AtkObject</a>*            : Read / Write</pre>
<p>Is used to notify that the table caption has changed.</p>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="AtkObject--accessible-table-column-description"></a><h3>The <code class="literal">"accessible-table-column-description"</code> property</h3>
<pre class="programlisting">  "accessible-table-column-description" <a
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gchar"
>gchar</a>*                : Read / Write</pre>
<p>Is used to notify that the table column description has changed.</p>
<p>Default value: NULL</p>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="AtkObject--accessible-table-column-header"></a><h3>The <code class="literal">"accessible-table-column-header"</code> property</h3>
<pre class="programlisting">  "accessible-table-column-header" <a class="link" href="AtkObject.html" title="AtkObject">AtkObject</a>*            : Read / Write</pre>
<p>Is used to notify that the table column header has changed.</p>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="AtkObject--accessible-table-row-description"></a><h3>The <code class="literal">"accessible-table-row-description"</code> property</h3>
<pre class="programlisting">  "accessible-table-row-description" <a
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gchar"
>gchar</a>*                : Read / Write</pre>
<p>Is used to notify that the table row description has changed.</p>
<p>Default value: NULL</p>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="AtkObject--accessible-table-row-header"></a><h3>The <code class="literal">"accessible-table-row-header"</code> property</h3>
<pre class="programlisting">  "accessible-table-row-header" <a class="link" href="AtkObject.html" title="AtkObject">AtkObject</a>*            : Read / Write</pre>
<p>Is used to notify that the table row header has changed.</p>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="AtkObject--accessible-table-summary"></a><h3>The <code class="literal">"accessible-table-summary"</code> property</h3>
<pre class="programlisting">  "accessible-table-summary" <a class="link" href="AtkObject.html" title="AtkObject">AtkObject</a>*            : Read / Write</pre>
<p>Is used to notify that the table summary has changed.</p>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="AtkObject--accessible-value"></a><h3>The <code class="literal">"accessible-value"</code> property</h3>
<pre class="programlisting">  "accessible-value"         <a
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gdouble"
>gdouble</a>               : Read / Write</pre>
<p>Is used to notify that the value has changed.</p>
<p>Allowed values: &gt;= 0</p>
<p>Default value: 0</p>
</div>
</div>
<div class="refsect1" lang="en">
<a name="AtkObject.signal-details"></a><h2>Signal Details</h2>
<div class="refsect2" lang="en">
<a name="AtkObject-active-descendant-changed"></a><h3>The <code class="literal">"active-descendant-changed"</code> signal</h3>
<pre class="programlisting">void                user_function                      (<a class="link" href="AtkObject.html" title="AtkObject">AtkObject</a> *atkobject,
                                                        <a
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gpointer"
>gpointer</a>   arg1,
                                                        <a
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gpointer"
>gpointer</a>   user_data)      : Run Last / Has Details</pre>
<p>
The "active-descendant-changed" signal is emitted by an object which has
the state ATK_STATE_MANAGES_DESCENDANTS when the focus object in the
object changes. For instance, a table will emit the signal when the cell
in the table which has focus changes.
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td><p><span class="term"><em class="parameter"><code>atkobject</code></em> :</span></p></td>
<td>the object which received the signal.
</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>arg1</code></em> :</span></p></td>
<td>the newly focused object.

</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>user_data</code></em> :</span></p></td>
<td>user data set when the signal handler was connected.</td>
</tr>
</tbody>
</table></div>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="AtkObject-children-changed"></a><h3>The <code class="literal">"children-changed"</code> signal</h3>
<pre class="programlisting">void                user_function                      (<a class="link" href="AtkObject.html" title="AtkObject">AtkObject</a> *atkobject,
                                                        <a
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#guint"
>guint</a>      arg1,
                                                        <a
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gpointer"
>gpointer</a>   arg2,
                                                        <a
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gpointer"
>gpointer</a>   user_data)      : Run Last / Has Details</pre>
<p>
The signal "children-changed" is emitted when a child is added or
removed form an object. It supports two details: "add" and "remove"
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td><p><span class="term"><em class="parameter"><code>atkobject</code></em> :</span></p></td>
<td>the object which received the signal.
</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>arg1</code></em> :</span></p></td>
<td>The index of the added or removed child
</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>arg2</code></em> :</span></p></td>
<td>A gpointer to the child AtkObject which was added or removed

</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>user_data</code></em> :</span></p></td>
<td>user data set when the signal handler was connected.</td>
</tr>
</tbody>
</table></div>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="AtkObject-focus-event"></a><h3>The <code class="literal">"focus-event"</code> signal</h3>
<pre class="programlisting">void                user_function                      (<a class="link" href="AtkObject.html" title="AtkObject">AtkObject</a> *atkobject,
                                                        <a
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gboolean"
>gboolean</a>   arg1,
                                                        <a
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gpointer"
>gpointer</a>   user_data)      : Run Last</pre>
<p>
The signal "focus-event" is emitted when an object gains or loses focus.
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td><p><span class="term"><em class="parameter"><code>atkobject</code></em> :</span></p></td>
<td>the object which received the signal.
</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>arg1</code></em> :</span></p></td>
<td>A boolean value which indicates whether the object gained or lost focus.

</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>user_data</code></em> :</span></p></td>
<td>user data set when the signal handler was connected.</td>
</tr>
</tbody>
</table></div>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="AtkObject-property-change"></a><h3>The <code class="literal">"property-change"</code> signal</h3>
<pre class="programlisting">void                user_function                      (<a class="link" href="AtkObject.html" title="AtkObject">AtkObject</a> *atkobject,
                                                        <a
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gpointer"
>gpointer</a>   arg1,
                                                        <a
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gpointer"
>gpointer</a>   user_data)      : Run Last / Has Details</pre>
<p>
The signal "property-change" is emitted when an object's property
value changes. The detail identifies the name of the property whose
value has changed.
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td><p><span class="term"><em class="parameter"><code>atkobject</code></em> :</span></p></td>
<td>the object which received the signal.
</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>arg1</code></em> :</span></p></td>
<td>The new value of the property which changed.

</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>user_data</code></em> :</span></p></td>
<td>user data set when the signal handler was connected.</td>
</tr>
</tbody>
</table></div>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="AtkObject-state-change"></a><h3>The <code class="literal">"state-change"</code> signal</h3>
<pre class="programlisting">void                user_function                      (<a class="link" href="AtkObject.html" title="AtkObject">AtkObject</a> *atkobject,
                                                        <a
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gchar"
>gchar</a>     *arg1,
                                                        <a
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gboolean"
>gboolean</a>   arg2,
                                                        <a
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gpointer"
>gpointer</a>   user_data)      : Run Last / Has Details</pre>
<p>
The "state-change" signal is emitted  when an object's state changes.
The detail value identifies the state type which has changed.
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td><p><span class="term"><em class="parameter"><code>atkobject</code></em> :</span></p></td>
<td>the object which received the signal.
</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>arg1</code></em> :</span></p></td>
<td>The name of the state which has changed
</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>arg2</code></em> :</span></p></td>
<td>A boolean which indicates whether the state has been set or unset.

</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>user_data</code></em> :</span></p></td>
<td>user data set when the signal handler was connected.</td>
</tr>
</tbody>
</table></div>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="AtkObject-visible-data-changed"></a><h3>The <code class="literal">"visible-data-changed"</code> signal</h3>
<pre class="programlisting">void                user_function                      (<a class="link" href="AtkObject.html" title="AtkObject">AtkObject</a> *atkobject,
                                                        <a
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gpointer"
>gpointer</a>   user_data)      : Run Last</pre>
<p>
The "visible-data-changed" signal is emitted when the visual appearance of 
the object changed.
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td><p><span class="term"><em class="parameter"><code>atkobject</code></em> :</span></p></td>
<td>the object which received the signal.

</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>user_data</code></em> :</span></p></td>
<td>user data set when the signal handler was connected.</td>
</tr>
</tbody>
</table></div>
</div>
</div>
<div class="refsect1" lang="en">
<a name="AtkObject.see-also"></a><h2>See Also</h2>
<p>
See also: <a class="link" href="AtkObjectFactory.html" title="AtkObjectFactory"><span class="type">AtkObjectFactory</span></a>, <a class="link" href="AtkRegistry.html" title="AtkRegistry"><span class="type">AtkRegistry</span></a>.
( GTK+ users see also <a
href="/usr/share/gtk-doc/html/gtk/GtkAccessible.html"
><span class="type">GtkAccessible</span></a>).
</p>
</div>
</div>
<div class="footer">
<hr>
          Generated by GTK-Doc V1.10</div>
</body>
</html>
